home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / LANG / BASIC / LIB / EVENTSHELL / DOCS / FontMenu < prev    next >
Text File  |  1996-04-11  |  3KB  |  119 lines
  1. This extension library should be installed using
  2. the LIBRARY command and initialised with a call
  3. to FN_shell_FontMenu_Init. This call must be
  4. made AFTER PROCshell_Init has been called.
  5.  
  6. --------------------------------------------------------
  7. FN_shell_FontMenu_Init
  8. =>    None
  9.  
  10. <=    bool    TRUE if module initialised correctly
  11.          FALSE otherwise
  12.  
  13. --------------------------------------------------------
  14.  
  15. FNshell_FontMenu_IsInitialised
  16. =>    none
  17.  
  18. <=    bool    TRUE if fontmenu module has
  19.          been initialised, otherwise FALSE.
  20.  
  21. --------------------------------------------------------
  22.  
  23. FNshell_FontMenu_GetHandle
  24. =>    none
  25.  
  26. <=    int    menu handle
  27.  
  28. --------------------------------------------------------
  29.  
  30. FNshell_FontMenu_OffersSystemFont
  31. =>    none
  32.  
  33. <=    bool    TRUE if fontmenu module contains a
  34.          'SystemFont' item, otherwise FALSE.
  35.  
  36. --------------------------------------------------------
  37.  
  38. FNshell_FontMenu_GetLastSelectedFont
  39. =>    none
  40.  
  41. <=    str    name of last valid font selected from
  42.          the menu i.e. 'Trinity.Medium'
  43.  
  44. If no valid font menu selection has been made
  45. the function will return "" and no action should
  46. be taken.
  47.  
  48. --------------------------------------------------------
  49.  
  50. FNshell_FontMenu_GetNrFonts
  51. =>    none
  52.  
  53. <=    int    nr of fonts in menu
  54.  
  55. --------------------------------------------------------
  56.  
  57. PROCshell_AttachFontMenu()
  58. =>    int    window handle
  59.     int    icon handle to attach menu to
  60.     int    icon handle to display selection
  61.     str    function to call when menu_select
  62.          event occurs (optional, may be "")
  63.     str    function to call before the menu
  64.          opens (optional, may be "")
  65.  
  66. Use this routine to attach the FontMenu to an icon or
  67. a window. Attach the FontMenu to an existing menu
  68. structure with <PROCshell_AttachFontSubMenu>.
  69.  
  70. This routine will NOT attempt to load the necessary
  71. 'FontMenu' support module if it is not already
  72. loaded. Add an entry in the !Run file to load it.
  73.  
  74. Selection FN (PROCshell_AttachFontMenu)
  75. =>    int    window handle
  76.     int    display icon handle
  77.     str    name of selected font i.e
  78.          'Trinity.Medium'.
  79.  
  80. <=    int    no meaning
  81.  
  82. PreOpen FN (PROCshell_AttachFontMenu)
  83. =>    int    handle of menu
  84.  
  85. <=    int    no meaning
  86.  
  87. Example !Run file entry (FontMenu)
  88. RMEnsure FontMenu 1.16 RMLoad <EvntShell$Path>FontMenu
  89. RMEnsure FontMenu 1.16 Error Couldn't load FontMenu Module
  90.  
  91. --------------------------------------------------------
  92.  
  93. PROCshell_FontMenu_SelectFont()
  94. =>    str    name of font to select i.e.
  95.          'Trinity.Medium'
  96.  
  97. The font name is used by the library routines
  98. to decide which font name to select when the
  99. font menu opens. As the same font menu can be
  100. used by different applications it is important
  101. to set this up just before the menu opens.
  102.  
  103. --------------------------------------------------------
  104.  
  105. PROCshell_FontMenu_AllowSystemFont
  106. =>    none
  107.  
  108. The 'SystemFont' item appears in the menu after this
  109. call.
  110.  
  111. --------------------------------------------------------
  112.  
  113. PROCshell_FontMenu_DisallowSystemFont
  114. =>    none
  115.  
  116. The 'SystemFont' item does not appear in the menu after
  117. this call.
  118.  
  119. --------------------------------------------------------